Magnum One

home *** CD-ROM | disk | FTP | other *** search

/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / autolog.arc / AUTOLOG.DOC next >

Wrap

Text File | 1990-01-05 | 13.6 KB | 521 lines

«RM80» AUTOLOG Version 1.00 Manual Copyright (c) 1990 by David A. Seidel All rights reserved. ----------------------------------------------------------------- AUTOLOG Page 1 Overview/Features ----------------- AUTOLOG is a Telix utility program that builds SALT scripts for automatic logging onto bulletin board and other on-line systems. While there exist other similar programs for Telix, AUTOLOG goes a bit further. Here are some of AUTOLOG's features: ∙ You can run AUTOLOG either with Alt-G or by linking it to a directory entry. ∙ AUTOLOG takes the name of the logon script file it creates directly from the name of the directory entry. ∙ You can take a "snap-shot" of any on-line prompt. ∙ You can record single-character responses (including Ctrl-C), as well as longer responses, even ones that don't end by pressing ENTER. ∙ Once you have finished recording prompts and responses, you can make AUTOLOG suspend operation until you go off-line. Then, AUTOLOG will automatically update the dialing direc- tory, making the new logon script the linked script for the entry. After that, AUTOLOG actually compiles the script. You don't have to do any more--you're set up for automatic logon next time you call the number. ∙ AUTOLOG keeps track of how much time elapses between prompts, which means that an accurate logon script is created. ∙ If you have your sound turned off, logon scripts generated by AUTOLOG display a "visual bell" on connection. ----------------------------------------------------------------- AUTOLOG Page 2 Included Files -------------- These are the files that are included in the AUTOLOG archive: AUTOLOG.SLC The compiled AUTOLOG program. AUTOLOG.DOC This file. VBELL.SLT A utility that provides a visual "ring" for phone connections, for those who like to keep the sound off. VBELL.SLC Compiled version of above. Installation ------------ Just copy AUTOLOG.SLC, VBELL.SLC, and VBELL.SLT into your Telix script directory. The Telix SALT compiler, CS.EXE, must be either in the directory from which you run Telix, or (preferably) in your PATH. ----------------------------------------------------------------- AUTOLOG Page 3 Starting AUTOLOG -- Option 1 ---------------------------- The first way to start AUTOLOG is to press Alt-G, type "autolog" and press ENTER. After the opening message, you will be prompted for the number of the directory entry to dial. Type the entry number and press ENTER. If you press ESC, press ENTER while the field is empty, or type an invalid entry number, AUTOLOG will abort. If the entry you want to dial has no name, you will be prompted for the name to use for the new logon script. You can type up to eight characters (no extension). You can use any legal DOS file name. Press ENTER to continue. See "Using AUTOLOG" for what to do next. Starting AUTOLOG -- Option 2 ---------------------------- The other way to start AUTOLOG is to link it to the directory entry for which you want to generate a logon script. (Press Alt- D, select the entry, press 'e' for (E)dit, press ENTER until you get to the "Linked script" field, type "autolog", then press ENTER until the editing window is gone.) Then (D)ial the number. Once the connection has been made, AUTOLOG will proceed, unless the entry has no name. In that case, you will be prompted for the name to use for the new logon script. You can type up to eight characters (no extension). You can use any legal DOS file name. Press ENTER to continue. See "Using AUTOLOG" for what to do next. ----------------------------------------------------------------- AUTOLOG Page 4 Using AUTOLOG ------------- AUTOLOG displays status messages on Telix's status line. Once on-line, AUTOLOG essentially has four operating "states," each of which has its own status message and its own special keys. The message displayed always tells you what state AUTOLOG is in and what special keys are valid at that moment. AUTOLOG makes a noise whenever the state changes. These are the messages, with explanations of what to do when you see them: "Dispaying: press ESC to quit" AUTOLOG is just displaying whatever is coming in over your modem. It will do this until there is a pause, or until the on-line program waits for input. If you press ESC, AUTOLOG will suspend operation until you go off-line. "Waiting: press INS, SPACE, or ESC" The on-line program has either paused for ten seconds or more, or is waiting for you to type something. You have three choices here: ∙ If a response is expected, press INS to record the prompt. This brings you to the "Recording prompt" state, below. ∙ If the on-line program is just pausing, press SPACE to display more. This brings you back to the "Displaying" state. If the on-line program pauses a lot, you may have to repeat this step a few times. ∙ If the on-line program is pausing, and you have already recorded everything you need to log on, press ESC. AUTOLOG will suspend operation until you go off-line. "Recording prompt" AUTOLOG is recording the on-line program's prompt. This is pretty fast, so the message will only appear briefly. This brings you to the next state, below. "Recording you: press END when done" The on-line program expects you to type something and you have just recorded the prompt. Just type whatever you have to type, including ENTER, if necessary. If the on-line program wants a single character, an ESC or a Ctrl-C, that's OK too. **IMPORTANT** -- When you have typed your complete response, press END. Your response will not be sent to the on-line program until you do so. Afterward, AUTOLOG will return to the "Displaying" state. ----------------------------------------------------------------- AUTOLOG Page 5 Using AUTOLOG (cont'd) ---------------------- So, this is the basic sequence once you're on-line: 1) Let the program display, pressing SPACE if necessary, until you see a prompt that you have to respond to. If you've finished recording everything you need to log on, press ESC. 2) Press INS to record the prompt. 3) Type your response and press END. 4) Repeat from step 1. That's it! When you go off-line, this is what AUTOLOG does: 1) A backup copy is made of the phone directory (i.e., TELIX.FON is copied to TELIX.BAK). 2) The phone directory entry for the number you called is modified so that the logon script that AUTOLOG wrote is linked to that entry. 3) The phone directory is reloaded. 4) The new logon script is compiled. AUTOLOG prints messages on the screen to confirm the success or failure of each of these steps. Error messages always start with "***". Things To Know -------------- ∙ When AUTOLOG is in the "Displaying" state, things are dis- played on the screen slower than they would otherwise. This should not cause any problems, except possibly when display- ing very complex full-screen ANSI pictures at 2400 baud, in which case these may be too much input for AUTOLOG to handle. If this occurs, try logging in at a slower baud rate with AUTOLOG. I use AUTOLOG at 2400, and I have rarely have any problems. However, I can't guarantee that AUTOLOG will work properly at speeds above 2400 baud. In any case, once you suspend AUTOLOG by pressing ESC, Telix takes over the screen display again, and everything comes back up to speed. ∙ If you don't like the sound that AUTOLOG makes when it changes states, just use the Alt-O menu to turn sound off in Telix. ----------------------------------------------------------------- AUTOLOG Page 6 AUTOLOG Logon Scripts --------------------- A few notes about the scripts generated by AUTOLOG: ∙ When AUTOLOG creates a logon script, it uses the first word in the name of the entry being called (if there is a name there); if the word is longer than 8 characters, only the first 8 are used. If that first word is an article (a, an, the, etc.) or if it is only one or two characters long, you might want to change the name before running AUTOLOG to get a more descriptive name for the logon script. For example, you could change the first space to an underscore (_). Alter- nately, you could let AUTOLOG run, and change the file name later, but then you have update the dialing directory too. ∙ You may find it necessary under some circumstances to edit and recompile a generated logon file. For example, you might mess up your on-line responses. In this case, AUTOLOG will faithfully record whatever happens, so you would probably want to go in and delete any mistakes. ∙ AUTOLOG keeps track, while on-line, of the elapsed time between responses, and uses that information to generate accurate waitfor() statements in the logon file. These timings may not be optimal, especially if the on-line program paused a lot, so adjust them if necessary. ∙ If you don't like the visual bell, delete the lines that say: if (!_sound_on) call("vbell"); Or, change VBELL.SLT to do something else. ----------------------------------------------------------------- AUTOLOG Page 7 Registration ------------ I know, I know, you're saying "Why should I bother registering?" Well, there are several good reasons: ∙ AUTOLOG is a good program. It will save you a lot of time and make your life easier. ∙ You'll feel much better if you do. ∙ You can get source code, updates, and maybe other stuff too (see below). To register, just mail me with a check for $8.00, along with your address, phone number and E-mail address, and what kind of disk you want (5.25 or 3.5). If you register, I will send you a ver- sion of AUTOLOG that doesn't have the repeating message at the end, with complete SALT source code. This version will also incorporate any changes and/or improvements that I've since made in the program. The disk may also contain new Telix (or related) stuff that I've written in the meantime. For example, I'm now working on a program to capture ANSI graphics screens with all escape codes and save them to disk. Also, if I update AUTOLOG after you register, I'll send you the update free. In any case, I hope you enjoy the program and get some use out of it. I welcome all comments and suggestions. Dave Seidel 9 Glenwood Blvd. Hudson, NY 12534 (518) 828-8456 Compuserve: 71511,2217 ----------------------------------------------------------------- AUTOLOG Page 8